home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / languages / hpasm3.10e.lha / HPAsm3.10e / docs / HPAsm.doc next >
Text File  |  1994-10-01  |  4KB  |  130 lines
  1.     *   * ****   ***   **** *   *       ****   ***   ****
  2.     *   * *   * *   * *     ** **       *   * *   * *
  3.     ***** ****  *****  ***  * * *       *   * *   * *
  4.     *   * *     *   *     * *   *       *   * *   * *
  5.     *   * *     *   * ****  *   *   *   ****   ***   ****
  6.     version 3.10 - September 1994 - Vallée Christophe
  7.  
  8. Excuse me for the language faults in this documentation but
  9. english is not my native language.
  10.  
  11. Introduction:
  12. -------------
  13.   HPAsm is an assembler for calculators with the Saturn microprocessor
  14.   (HP48S(X),HP48G(X),HP28S...)
  15.   HPAsm has its own editor and needs kickstart2.04 (V37) or more to work.
  16.  
  17. 0. Start:
  18. -------------
  19.  Under shell:
  20.    HPAsm  
  21.    ou
  22.    HPAsm FileName
  23.  Under Workbench:
  24.    Click either on HPAsm's icon or on an icon of a file saved by HPAsm
  25.  
  26. 1. The Syntaxe:
  27. --------------
  28.  Each line must have the following format:
  29.     Label    Mnemonic    Operand    Comment
  30.  
  31.     ex:
  32.     start    lc(5)    1994    load c register
  33.         a=dat1    xs
  34.  
  35.  If the line begins by '*' it is a comment line
  36.  
  37.  Each label if present must begin a column 1. All symbols but figures (0-9)
  38.  and operation symbols (*/-+) are allowed for the first letter of a label
  39.  For the others letter , all symbols but operation symbols(*-+/) are allowed
  40.  If there is no label the line must begin with space(s) or tabulation(s)
  41.  
  42.  If a line doesn't have an operand , then the comment must begin with
  43.  a '*'
  44.  
  45.  LC instruction expect hexadecimal ($xxxx)
  46.  If the size is written (ex: Lc(x) 1<=x<=8) it expects an expression
  47.  
  48.  The instructions P=, CPEX, C=P, P=C, ABIT=0, ABIT=1, CBIT=0, CBIT=1,
  49.  ?ABIT=0, ?ABIT=1, ?CBIT=0, ?CBIT=1, ?P=, ?P#, HS=0, ?HS=0 expect
  50.  a number between 0 and 15  (ex: p=   15) and not between 1-16
  51.  
  52.  Symbols signs for tests are =, #, <=, et >=
  53.  
  54.  HPASM doesn't make difference between lower case and upper case
  55.  in the instruction (lc = LC) but if does for the label (Start # staRT)
  56.  
  57.  HPASM accepts expressions with parenthesis, with labels and evaluate them
  58.  according to the following priorities or from left to right if same priority
  59.     .  - + ~(not)
  60.     .  &(and) !(or) |(or) ^(xor)
  61.     .  *(multiplication) /(division)
  62.     .  +(addition) -(substraction)
  63.  All operations are done in sign 32 bits
  64.  In expressions HPASM accepts decimal (455), hexadécimal ($8f7)
  65.  and binary (%011101)
  66.        
  67.  See examples file for more informations about the format.
  68.  
  69. 2.Assemblage:
  70. -----------------
  71.  Menu 'Assemble' in HPAsm assemble the text on disk either in 
  72.  Ascii mode or in binary mode (in this mode the object begins with
  73.  'HPHP48-E') according the preferences
  74.  The code is saved on the disk under the name specified in the
  75.  preferences, in the directory of the project if no specified
  76.  (RQ: if in the name there is a '*' , then the '*' will be replaced
  77.  by the name of the project without is extension )
  78.  
  79.  Menu 'check' assemble the text but doesn't save it on disk.
  80.  
  81. 3.Pseudo operations:
  82. ------------------------
  83.     con(x)    expression
  84.     include constants and reverse them (1=<x=<8)
  85.  
  86.     hex    $xxxxx
  87.     include hexadecimal but without reversing 
  88.  
  89.     asc    'Texte ascii'
  90.     asc    "Texte ascii"
  91.     include ascii
  92.  
  93.     mem    n
  94.     include n quartets
  95.  
  96.  Label    =    expression
  97.  Label    equ    expression
  98.     assign a value to a label
  99.  
  100.     include    FileName
  101.     include a source file in assemblage, HPAsm searches the file in the
  102.     project's directory if no directory is specified . If a project
  103.     has the same name that FileName then the project is used instead
  104.     of loading another file
  105.  
  106. 4.The editor:
  107. -------------
  108.  Option 'Save preferences' saves the active window position, ascii window
  109.  position, ASL.library window position, and the preferences !
  110.  The file created has the name 'HPAsm3.10.prefs' and is saved in 
  111.  both directory ENV:HPAsm and ENVARC:HPAsm
  112.  When icon option is enabled, HPAsm uses the icons code.info and source.info
  113.  if these icons are present in the directory ENV:HPasm
  114.  
  115.  The HPTopaz font in this archive is the standard topaz/8 font with 
  116.  HP specials codes (128 to 160)
  117.  
  118. 5.Notes:
  119. --------
  120.  HPAsm has been created with the help of the book 'VOYAGE AU CENTRE DE LA
  121.  HP48' which is published in french and which is available in France
  122.  Publisher: ANGKOR Authors:Paul COURBIS, Sebastien LALANDE
  123.  ISBN 2-87892-003-1  
  124.  
  125.  HPAsm has been tested succesfull with the following configurations:
  126.    . A500 1meg K2.04
  127.    . A1200
  128.  
  129. buggs ? ---> vallee@ensea.fr
  130.              minitel RETL bal OSCAR